home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #160 (1992-02)(Rhein-Sieg-Soft).zip / Franz PD Disk #160 (1992-02)(Rhein-Sieg-Soft).adf / ArcL_&_Axpr / AXPR.dok < prev    next >
Text File  |  1991-12-07  |  10KB  |  250 lines

  1.  
  2.  
  3.                                   AXPR
  4.  
  5.                                Version 2.1
  6.  
  7.                    Assembler - XPR - Transfer - Protokoll
  8.  
  9.                                    von
  10.  
  11.                              Thomas Globisch
  12.  
  13.                                  26.11.91
  14.  
  15.  
  16.                   !!  Bitte unbedingt Kapitel III lesen  !!
  17.  
  18. I. Distribution
  19.  
  20. Das Urheberrecht sämtlicher zum Programm gehörender Teile liegt, sofern
  21. nicht anders angegeben, beim Autor.
  22.  
  23. Dieses Programm ist Public Domain und darf jederzeit weitergegeben werden.
  24. Einschränkung : Das Programm darf nur komplett mit unveränderter Dokumen-
  25. tation kopiert werden und es darf bei der Verbreitung keinerlei Gewinn
  26. gemacht werden. Die Verbreitung durch Mailboxen und Netz-Systeme ist
  27. ausdrücklich erlaubt und gewünscht, allerdings dürfen diese Mailboxen keinen
  28. kommerziellen Charakter haben.
  29.  
  30. Wird dieses Programm auf Diskette weiterverbreitet. darf eine Kopiergebühr
  31. von max 2.- DM ohne Disk und 5.- DM mit Disk erhoben werden. Alles, was diese
  32. Angaben üBERSTEIGT wird vom Autor als PROFESSIONELLES VERKAUFEN angesehen und
  33. entsprechend geahndet !!
  34.  
  35. Die Verbreitung des Programms im Zusammenhang mit kommerziellen Programmen
  36. benötigt die schriftliche Einwilligung des Autors.
  37.  
  38. Anfragen bezüglich PDs, Erfahrungsaustausch, Programmieraufträge,
  39. Amiga 3000 Geschenke, Flug nach California oder was weiß ich
  40.                                             ... sind auch immer willkommen.
  41.  
  42.  
  43. Files im Archiv : 2
  44.  
  45.    AXPR
  46.    Anleitung.AXPR
  47.  
  48.  
  49. II. Anleitung
  50.  
  51. Dieses Programm ist, wie der Name schon sagt, ein Filetransferprotokoll,
  52. das den XPR 2.0 Standard unterstützt, und dabei äußerst benutzerfreundlich
  53. ist.
  54.  
  55. Das Programm dient als Ersatz für ähnliche Programme wie z.B. XPRD,
  56. ohne jedoch die vielen Schwächen zu übernehmen.
  57.  
  58. Die Transferroutinen dieses Programmes sind vollständig in Assembler
  59. geschrieben, um einen größtmöglichen Datendurchsatz zu erreichen.
  60.  
  61. Dieses Programm läuft auf allen Rechnern mit min. 256 KB RAM bis
  62. 16 MB RAM, unter Kick 1.1, Kick 1.2, Kick 1.3, Kick 2.0, Kick 2.1 u.s.w,
  63. unter 68000, 68010, 68020, 68030, 68040 ?? Prozessoren !
  64. Weiterhin wird ab sofort auch der 2-Byte-Sende-Guru einiger xpr-libraries
  65. abgefangen, der entsteht, wenn bei der Berechnung der CPS-Rate eine
  66. Division durch 0 entsteht.
  67.  
  68. Bedienung :
  69.  
  70. Der Programmaufruf ist ähnlich wie bei XPRD, obwohl einige Änderungen gemacht
  71. wurden. Dieses ist mit Absicht so, damit es bei der Umstellung wenig Probleme
  72. gibt.
  73.  
  74. Die Funktionen :
  75.  
  76. Aufruf : AXPR [-Optionen] S|R [Filename]
  77.  
  78. Alle Optionen beginnen mit einen '-' und einem darauffolgenden Buchstaben und
  79. können in einer beliebigen Reihenfolge angegeben werden (bis auf -F).
  80.  
  81.   Optionen : 
  82.               -L  Definiert eine neue xpr.library. Dabei ist der vollständige
  83.                   Libraryname anzugeben Voreingestellt ist 'xprzmodem.library'
  84.  
  85.               -O  Gibt den Library-Initstring an. Näheres dazu findet man in
  86.                   den Beschreibungen zu den einzelnen Libraries.
  87.                   Der Standard-Zmodem-Initstring lautet bei mir z.B.
  88.                   TC,ON,B16,F0,AY,DN,KY,SN,RN,PDH1:DOWNLOADS
  89.  
  90.                -D Definiert das benutzte Device. Standard ist das
  91.                   serial.device, benutzt man ein internes Modem, muß man hier
  92.                   den betreffenden Namen eintragen.
  93.  
  94.                -U Stellt die Unitnummer ein, normalerweise 0 (Voreingestellt).
  95.  
  96.                -X Legt die Baudrate fest. Voreingestellt ist 2400 Baud.
  97.                   HST-User müssen hier 19200 bzw 38400 Baud einstellen.
  98.  
  99.            -G Legt die X-Position des Transferwindows fest.
  100.  
  101.                -V Legt die Y-Position des Transferwindows fest
  102.           VORSICHT : Werden zu große / kleine Werte angegeben, so
  103.                   läßt sich das Transferwindow nicht öffnen und der
  104.                   Transfer wird abgebrochen !
  105.  
  106.                -S Öffnet das angegebene Device im sog. SHARED-Modus. Das
  107.                   bedeutet, daß mehrere Programme auf das gleiche Device
  108.                   zugreifen können. Wird -S nicht angegeben, wird das
  109.                   Device 'normal' geöffnet. Wurde das device mittels
  110.                   SHARED geöffnet, funktioniert der RTS-CTS-Handshake
  111.                   nicht mehr. Dieses ist ein Problem des serial.device
  112.                   und keine Fehlfunktion von AXPR.
  113.  
  114.                -C Carrier-überwachung ein. Beim verlust des Carriers wird
  115.                   die Übertragung abgebrochen.
  116.  
  117.                -H Hochgeschwindigkeitsmodus ein. Wird dieses benutzt, kann
  118.                   nur noch mit 8N1 gesendet/empfangen werden, diese
  119.                   Einstellung ist aber fast immer gegeben, so daß man diesen
  120.                   Modus in den Meisten Fällen benutzen kann. Dieser Parameter
  121.                   schaltet den Software-Overhead aus (für die Fachleute).
  122.           Bringt allerdings nur was mit Modems >9600 Baud.
  123.  
  124.            -A Öffnet Window auf dem vordersten Screen.
  125.                   VORSICHT : Crashgefahr !!
  126.  
  127.     Änderungen Version 2.1 :
  128.  
  129. Die Option -E sollte nicht mit irgendeiner anderen Option gleichzeitig
  130. verwendet werden !!
  131.  
  132. Die Option -F MUß UNBEDINGT als letzte Option angegeben werden und sollte
  133. nicht mit -O kombiniert werden, da diese Option dann ignoriert wird.
  134.  
  135.                -E Übernehmen der Environment-Einstellung. Diese Option 
  136.           übernimmt die Einstellung aus der Environmant-Variablen
  137.  
  138.                -F Frage den User nach Optionen.
  139.  
  140.                   Achtung : Diese Option MUß UNBEDINGT als letzte Option
  141.                             überhaupt angegeben werden !
  142.                             Wird -F angegeben, so wird -O ignoriert !!
  143.  
  144.                   Es wird ein Fenster geöffnet, in dem man einfach per
  145.                   Mausklick die verschiedenen Optionen eines Protokolls
  146.                   einstellen kann. Mit dem Schließgadget wird die Einstellung
  147.                   übernommen und der Transfer begonnen.
  148.  
  149.           Anschleißend werden die benutzten Optionen noch einmal
  150.                   ausgegeben. Diese Optionen kann man später mittels -O
  151.                   setzen, und die Userabfrage übergehen.
  152.  
  153.  
  154.  S|R    Dient zum Senden eines Files (S) oder zum Empfangen (R)
  155.  
  156.  
  157.  Filename : Filename, der gesendet oder empfangen wird.
  158.  
  159.  
  160.  
  161. III. Spezielle Anmerkungen :
  162.  
  163. 1. Dieses Programm unterstützt das RTS-CTS Handshaking.
  164.  
  165.    Das bedeutet : a) Das Modem muß auf RTS-CTS-Handshake eingestellt werden,
  166.                      um ein einwandfreies Funktionieren zu gewährleisten.
  167.  
  168.                   b) Die Baudrate kann bei einem MNP5 - Modem auf 4800,
  169.                      mit einem MNP5 V42bis Modem auf 9600 Baud, und mit
  170.                      einem HST auf 19200 bzw. 38400 Baud eingestellt werden.
  171.  
  172. 2. Der angegebene Filename ist Gesetz. Das bedeutet auch, daß man einen
  173.    vollständigen Namen angeben muß. Ein Pfad alleine reicht nicht !
  174.  
  175.    Das bedeutet : a) Beim Senden merkt man keinen Unterschied, das angegebene
  176.                      File wird gesendet.
  177.  
  178.                   b) beim Empfangen gibt es nun 2 Möglichkeiten :
  179.  
  180.                      1. Wird KEIN Filename angegeben, wird der Name vom
  181.                         Protokoll verwendet. Ein Beispiel :
  182.                         Der Aufruf 'AXPR R' bewirkt, daß ein File mittels
  183.                         ZMODEM unter dem vom Sender vorgeschagenen Namen
  184.                         in dem mit P eingestellten Verzeichnis empfangen wird.
  185.                         Genau wie bei XPRD also. (P ist eine zmodem-Option)
  186.  
  187.                      2. Wird ein Name angegeben, so wird das File GENAU UNTER
  188.                         DIESEM NAMEN empfangen, egal, was z.B. zmodem
  189.                         vorschlägt.
  190.  
  191.                         Wozu das nun wieder ??
  192.  
  193.                         Ganz einfach : Mein Z-Netz-Server sendet mir beim
  194.                         Pollen ein File Namens 'Out.Arc', das aber dummer-
  195.                         weise mit LHarc gepackt ist. Genau dieses verkraftet
  196.                         aber MyBBS nicht, da MyBBS unbedingt ein File Namens
  197.                         Called.lzh verlangt. Jetzt gebe ich einfach als
  198.                         Namen 'Zerberus:Called.lzh' an und alles klappt
  199.                         einfach hervorragend.
  200.  
  201. 3. Die Einstellung per Environment-Variablen :
  202.  
  203. Es kann mittels Environment-Variablen die Einstellung von AXPR
  204. vorgenommen werden. Danach braucht AXPR nur noch mit AXPR -E S|R [FileName]
  205. aufgerufen zu werden, um eine komplette Einstellung aller Optionen vorzunehmen.
  206.  
  207. Es muß sich ein ASCII-File Namens AXPR im ENV: - Verzeichnis befinden, daß
  208. man mit jedem TextED erstellen kann.
  209.  
  210. Dabei kann man folgendes Einstellen (unbedingt GROSSSCHREIBEN):
  211.  
  212.   LIBRARY=xprxmodem.library     definiert eine neue Library
  213.   OPTIONS=tn,oy,.....          setzt die library-spezifischen Optionen
  214.   DEVICE=serial.device        legt das Device fest
  215.   UNIT=3            setzt als Unit 3
  216.   GESCHW=19200            setzt 19200 als serielle übertragungsrate
  217.   SHARED=1            öffnet device als SHARED
  218.   CARRIER=0            schaltet die Carrier-Überwachung aus
  219.   HIGHSPEED=1            schaltet auf Hochgeschw.modus (RAD_BOOGIE)
  220.   FRAGE=1            fragt nach Optionen
  221.   XPOS=20            Setzt die hoizont. Position des Transferwin.
  222.   YPOS=20            Setzt die vert. Position des Transferwindows
  223.   SCREEN=1            öffnet das Window auf dem vordersten Screen
  224.                                 (Crashgefahr !! Highly Experimental)
  225.  
  226. Dabei steht <>1 für aus, 1 für ein. Alle Optionen, die man nicht angibt,
  227. werden aus der Standardeinstellung übernommen. Falscheingaben werden
  228. beanstandet, aber führen nicht zum Abbruch des Programmes, da dann die Standard-
  229. einstellung verwendet wird. Dieses gilt nicht für falsche Positionsangaben,
  230. kann Aufgrund zu großer/negativer Positionsangaben das Window nicht geöffnet
  231. werden, wird der Transfer abgebrochen !
  232.  
  233. Auch hier gilt :
  234.  
  235.   FRAGE=1 muß als letztes stehen !!
  236.  
  237. Das war's.
  238.  
  239.  
  240. Dieses Programm ist von:
  241.  
  242. Thomas Globisch
  243. Emilstr. 36
  244. 5600 Wuppertal 2
  245.  
  246.  
  247. TH_GLOBISCH@AWORLD.ZER   Z-Netz
  248.  
  249. thg@uni-paderborn.de  (E-Mail)
  250.